home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / mus / misc / play_handler_s.lzh / play-handler / play-handler.lha / PLAY-Handler.dok < prev    next >
Text File  |  1995-01-25  |  4KB  |  93 lines
  1.  
  2.                 PLAY-Handler  Doku
  3.  
  4. Achtung:  Dieses Programm ist Shareware. Es darf frei kopiert und
  5. verbreited werden, solange dies kostenlos geschieht und nur vernuenftige
  6. Gebuehren fuer das Medium erhoben werden. Ausserdem muessen folgende
  7. Dateien komplett und unveraendert zusammen bleiben:
  8. play-handler.dok, play-handler.doc, play-handler, PLAY, PLAY.info,
  9. mountlist.play, install
  10. Desweitern wird keine Haftung fuer irgentwelche Folgen fuer die Umwelt, den
  11. Computer, die Stereoanlage oder sonstwas uebernommen, die durch die
  12. Benutzung dieses Programms entstehen.
  13. Es darf ausserdem nicht als Zugabe zu kommerziellen Produkten beigefuegt
  14. werden. Fuer diesen Fall ist eine schriftliche Vereinbahrung mit mir
  15. noetig. (Ausserdem wuerde ich die Vollversion vorziehen.)
  16.  
  17. Dies ist eine eingeschraenkte Version. Die Beschraenkungen beziehen sich
  18. darauf, dass der PLAY-Handler nur einmal geoeffnet werden kann, und sich
  19. nach dem Schliessen selbst wieder entfernt. Um ihn nochmal zu benutzen,
  20. muss er neu gemounted werden.
  21. Wem das Programm so gut gefaellt, dass er eine uneingeschraenkte Version
  22. haben moechte, moechte mir 10DM zukommen lassen. Diejenigen, die das
  23. Programm gerne per Post auf Diskette haben moechten, legen bitte nochmal
  24. 5DM drauf fuer Diskette, Transportumschlag und Porto (zusammen 15DM).
  25. Alternativ kann man mir dies alles auch zuschicken (d.h. einen frankierten
  26. Umschlags fuer die Diskette und die Diskette selber), dann bleibt es bei 10DM.
  27. Denjenigen mit E-Mail-Anschluss kann ich das Programm kostenlos zumailen
  28. (uuencoded, getarred und gezipped = .tar.gz.uu).
  29. Als Zahlungsmittel akzeptiere ich Bargeld (bitte Scheine) oder Euroschecks.
  30.  
  31. Zu erreichen bin ich unter folgender Adresse:
  32.  
  33. Joerg Dorchain
  34. Harspergerflur 23
  35. D-66740 Saarlouis
  36. Deutschland
  37. Tel.:+49/6831/892656 (aber eher zufaellig)
  38.  
  39. E-Mail: dorchain@mpi-sb.mpg.de
  40.  
  41.  
  42. So, nachdem die rechtlichen Details geklaert sind, zum wesentlichen,
  43. naemlich dem Programm.
  44.  
  45. Installation:
  46. Diese beschraenkt sich auf ein Minimum. Man kann das Installationsskript
  47. benutzen, oder von Hand play-handler nach l: kopieren, und anschliessend
  48. PLAY und PLAY.info nach devs:dosdrivers bzw. mountlist.play an
  49. devs:mountlist anhaengen. Anschliessend kann man den Handler mit mount
  50. play: starten.
  51.  
  52. Benutzung:
  53. Play: bietet ein Interface zum Audio.device fuer fertige Samples (raw oder
  54. 8SVX=Iff) an. Es ist ein Stream-Handler, der nur beschrieben werden kann.
  55. (Das Mikrophon ist noch nicht im Amiga eingebaut. ;-)) Man oeffnet "play:"
  56. als normale Datei und schreibt rein, was man hoeren will, am einfachsten
  57. mit copy <sample> play:. (Vorsicht: Je nach Groesse des Samples und dem
  58. Max-Transfer Wert des Dateisystems kann der Speicher knapp werden).
  59. Von type <sample> to play: ist abzuraten. Erstens veraendert type
  60. nichtdruckbare Zeichen, und zweitens kopiert es daten 196-byte-weise,
  61. was ein bisschen langsam ist. Join dagegen funktioniert einwandfrei.
  62. Wenn man play: mit zu kleinen Haeppchen (unter 256 Byte) fuettert, kann
  63. es sein, dass der Ton aussetzt, da play: nicht schnell genug neue
  64. Sounddaten bekommt. Die Samples werden im Double-Buffering-Verfahren
  65. abgespielt, so dass bei kontinuierlicher Eingabe ununterbrochen was
  66. aus dem Lautsprecher kommt.
  67. Die Zahl der internen 512-Byte Puffern kann man mit dem Addbuffers-Befehl
  68. ansehen und aendern.
  69. Ueber den Dateinamen kann man das Verhalten von play: beeinflussen.
  70. play: oeffnet einen Monokanal und hat fuer Raw-Samples die Voreinstellung
  71.     8192 Samples/Sekunde. (Iff-Samples werden mit ihren eigenen
  72.     Sampling-Rate abgespielt.)
  73. play:s spielt das Sample ueber einen Stereaokanal. (links wie rechts
  74.     dasselbe)
  75. play:l spielt nur links
  76. play:r spielt nur rechts
  77. play:<zahl> spielt das Sample (auch Iff-Samples) mit <zahl> Samples/Sekunde ab.
  78.  
  79. Beides kann kombiniert werden, wobei der Buchstabe vor der Zahl kommen
  80. muss. Beispiel: play:s10000 spielt das Sample in Stereo mit 10000 Samples
  81. pro Sekunde ab. Vorsicht: Die Samplingrate wird nicht ueberprueft. Extreme
  82. Werte koennen merkwuerdige Ergebnisse liefern.
  83. Play: kann mehrfach geoeffnet werden, solange Speicher und Soundkanaele da
  84. sind, so das mehere Samples gleichzeitig gespielt werden.
  85.  
  86. Ach ja, es sollte unter allen OS-Versionen laufen. (getestet mit V3.0)
  87.  
  88. Fehler (uhh), Vorschlaege und sonstige Rueckmeldungen sind herzlich
  89. wilkommen. Ansonsten viel Spass beim ausprobieren
  90.  
  91. Joerg
  92.  
  93.